home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / fx / dmFXSplitFields.z / dmFXSplitFields
Encoding:
Text File  |  1998-10-20  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddmmmmFFFFXXXXSSSSpppplllliiiittttFFFFiiiieeeellllddddssss((((3333ddddmmmm))))                                      ddddmmmmFFFFXXXXSSSSpppplllliiiittttFFFFiiiieeeellllddddssss((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddmmmmFFFFXXXXSSSSpppplllliiiittttFFFFiiiieeeellllddddssss - split a frame out into two fields
  10.  
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ffffxxxx____bbbbuuuuffffffffeeeerrrr....hhhh>>>>
  14.  
  15.      DDDDMMMMssssttttaaaattttuuuussss ddddmmmmFFFFXXXXSSSSpppplllliiiittttFFFFiiiieeeellllddddssss
  16.            (((( iiiinnnntttt iiiinnnnppppuuuuttttUUUUssssaaaaggggeeee,,,,
  17.              DDDDMMMMffffxxxxbbbbuuuuffffffffeeeerrrr ****ssssrrrrccccFFFFrrrraaaammmmeeee,,,,
  18.              DDDDMMMMffffxxxxbbbbuuuuffffffffeeeerrrr ****ffffiiiieeeellllddddAAAA,,,,
  19.              DDDDMMMMffffxxxxbbbbuuuuffffffffeeeerrrr ****ffffiiiieeeellllddddBBBB ))))
  20.  
  21.  
  22. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  23.      _i_n_p_u_t_U_s_a_g_e   Specifies the modes in which the destination field buffers
  24.                   (ffffiiiieeeellllddddAAAA and ffffiiiieeeellllddddBBBB) will be used as input; says how the
  25.                   image will be read from the buffers and used as input to a
  26.                   plug-in or application.  The value is a bitwise combination
  27.                   of one or more of:  bbbbuuuuffffIIIInnnnppppuuuuttttDDDDiiiirrrreeeecccctttt, bbbbuuuuffffIIIInnnnppppuuuuttttTTTTeeeexxxxttttuuuurrrreeee,
  28.                   bbbbuuuuffffIIIInnnnppppuuuuttttDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, bbbbuuuuffffIIIInnnnppppuuuuttttMMMMoooovvvviiiieeee.  The options set must
  29.                   include all of the different ways in which ffffiiiieeeellllddddAAAA and ffffiiiieeeellllddddBBBB
  30.                   will be used.
  31.  
  32.      _s_r_c_F_r_a_m_e     The source frame to copy scanlines from.  The even numbered
  33.                   scanlines (counting from 0) will be copied to ffffiiiieeeellllddddAAAA, and
  34.                   the odd numbered scanlines will be copied to ffffiiiieeeellllddddBBBB.
  35.  
  36.      _f_i_e_l_d_A       The "top-most" field.
  37.  
  38.      _f_i_e_l_d_B       The "bottom-most" field.
  39.  
  40.  
  41. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  42.      ddddmmmmFFFFXXXXSSSSpppplllliiiittttFFFFiiiieeeellllddddssss will create two fields from a single frame.  The source
  43.      frame buffer must be twice the height of the two field buffers (see
  44.      mmmmFFFFXXXXAAAAllllllllooooccccaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrrssss), and the source frame width must match the width
  45.      of the two field buffers.
  46.  
  47.      The scanlines from the source frame are split out into two field buffers.
  48.      The even numbered scanlines (counting from 0) from the source frame
  49.      (ssssrrrrccccFFFFrrrraaaammmmeeee) are copied into ffffiiiieeeellllddddAAAA, and the odd numbered scanlines are
  50.      copied into ffffiiiieeeellllddddBBBB.
  51.  
  52.  
  53. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  54.      ddddmmmmFFFFXXXXSSSSpppplllliiiittttFFFFiiiieeeellllddddssss will return DDDDMMMM____SSSSUUUUCCCCCCCCEEEESSSSSSSS on success, and DDDDMMMM____FFFFAAAAIIIILLLLUUUURRRREEEE on
  55.      failure.  In the case of failure, error information can be obtained from
  56.      ddddmmmmGGGGeeeettttEEEErrrrrrrroooorrrr((((3333ddddmmmm)))).  Potential reasons for failure include:
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddmmmmFFFFXXXXSSSSpppplllliiiittttFFFFiiiieeeellllddddssss((((3333ddddmmmm))))                                      ddddmmmmFFFFXXXXSSSSpppplllliiiittttFFFFiiiieeeellllddddssss((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      _F_X__E_R_R_O_R__B_A_D__P_A_R_A_M_E_T_E_R   The height of the source frame buffer is not 2
  75.                               times the height of the destination field
  76.                               buffers
  77.  
  78.      _F_X__E_R_R_O_R__B_A_D__P_A_R_A_M_E_T_E_R   The width of the source frame buffer is not
  79.                               equal to the width of the destination field
  80.                               buffers
  81.  
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      dmFXJoinFields(3dm), dmFXMovieRenderFields(3dm),
  85.      dmFXMovieInsertFields(3dm), dmFXAllocateImageBuffers(3dm), DMbuffer(4)
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.